home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d17 / lpr_lpq3.arc / README < prev    next >
Text File  |  1989-10-14  |  5KB  |  84 lines
  1. LPR and LPQ are two utilities to work with the standard MSDOS background
  2. printing program and enhance it's usefulness.
  3.  
  4.         LPR lets you pipe standard input into a spool file, which is then
  5. passed to the print queue maintained by the DOS print.com utility.  File
  6. arguments (with wildcards) to lpr are also passed to print. Calls to lpr
  7. and print may be freely mixed.  Added bonuses are a logging of the time of
  8. each print job, and a rush option to insert a job at the head of the queue.
  9. The spool files are created in a special spool directory, and automatically
  10. deleted by a later call to lpr.  LPR does not look at the file in any way,
  11. except for the following:
  12.  - input files which are empty are not printed.
  13.  - a formfeed as the last character in the file is stripped, since PRINT
  14.    will supply one for you (at least my print does - DOS 4.01)
  15.  
  16.         LPQ is a utility to display and manipulate the print queue.  It
  17. displays the files in the queue, each with a job number, file size, and the
  18. time of entry (if they were inserted by LPR and not PRINT).  In addition,
  19. it can cancel individual files by job number, cancel all jobs files, or
  20. move a given job to the head of the queue.  It can also suspend print
  21. operations (thus leaving the printer port free to other applications such
  22. as word processors), and then restore the queue and resume printing later.
  23. The percentage already printed is displayed for the file at the head of the
  24. queue (this may not be very meaningful if you use a large printer buffer)
  25.  
  26. Of course, PRINT should be already resident and pointing at the correct
  27. printer port before you run LPR. (It checks for this first).
  28.  
  29. The source was compiled with TurboC v2.0, tiny model and converted to .com
  30. It has been tested on DOS v 3.1 and 4.01.  It has not been tested under 2.x
  31. and probably will not work.  The multiplex interrupt 2F was undocumented then
  32. but print.com was using it (according to Norton).
  33.  
  34. Archive lpr-lpq.zoo:
  35. Length    CF  Size Now  Date      Time
  36. --------  --- --------  --------- --------
  37.    15905  53%     7524  14 Oct 89 13:17:14   lpq.c
  38.     4064  50%     2019  14 Oct 89 13:19:20   lpq.doc
  39.     3760  49%     1925  14 Oct 89 13:19:30   lpq.man
  40.    21443  52%    10283   4 Oct 89 22:58:34   lpr.c
  41.     3833  45%     2110  14 Oct 89 13:19:00   lpr.doc
  42.     3569  43%     2022  14 Oct 89 13:19:12   lpr.man
  43.     2320  43%     1312  14 Oct 89 13:14:16   makefile
  44.     4237  41%     2497  14 Oct 89 13:28:58   readme
  45.     5654  51%     2755   4 Oct 89 22:58:34   setargv.c
  46.     1690  73%      450   5 Oct 89 10:38:20   tcconfig.tc
  47.     1038   7%      966   5 Oct 89 10:24:14   wildargs.obj
  48.    13506  17%    11208  14 Oct 89 13:18:10   lpq.com
  49.    19450  20%    15514  14 Oct 89 13:17:54   lpr.com
  50. --------  --- --------  --------- --------
  51.   100469  40%    60585    13 files
  52.  
  53. Compilation notes.
  54. With Turbo-C, use the integrated environmant and the supplied .TC and .PRJ
  55. files.  The makefile supplied assumes NDMAKE as the make program, TCC as the
  56. compiler and 4DOS as the shell.  If you know enough to be recompiling these
  57. programs I'll presume you know how to change the makefile to suit your
  58. system.  Borlands MAKE can handle the makefile with minor editing, but not
  59. the lines with i/o redirection.  The 4DOS features used here are multiple
  60. wildcards as arguments to del, and the except command, which simply sets the
  61. hidden attribute on the (file list) before executing the command.  The
  62. program notroff is a filter for inserting bold, underline etc. codes into a
  63. file for printing or display under ansi.sys.  The .doc files have been
  64. formatted with embedded ansi codes, and the .man files have no codes.
  65. The wildargs.obj file is a modified version of the wildcard argument expander
  66. supplied with TurboC.  I changed it to allow "/" as well as "\" to be
  67. correctly recognised in wildcards, and to allow "[" and "]" in filenames
  68. to be recognised as wildcard indicators.  This is to allow lpr to be used
  69. with the WILDUNIX tsr to accept a command like "lpr chap[1-4].txt" which
  70. would not otherwise be recognised as a wildcard.  Since the source in
  71. setargv.asm is (c) Borland, I included only the .obj file in the distribution.
  72.  
  73.  
  74. LPR and LPQ are copyright (1989) by Richard Brittain
  75. Permission is granted to freely use and distribute these programs as long as
  76. my copyright notice is not removed.  These programs may not be sold.
  77.  
  78. All comments, suggestions etc. welcome at any of the addresses below.
  79.  
  80. Richard Brittain, School of Elect. Eng., Upson Hall Cornell University,
  81. Ithaca, NY 14853
  82. ARPA: richard@calvin.spp.cornell.edu
  83. UUCP: {uunet,uw-beaver,rochester,cmcl2}!cornell!calvin!richard
  84.